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INTRODUCTION 

This Installation Guide describes the procedure for 
generating a configuration of Turbo-Plus to meet a given system's 
specifications. 

For information on using the package refer to the User* s 
Guide to Turbo-Plus . That manual includes an overview of the 
package, and instructions on using each command. 

Turbo-Plus is designed with the ability to be patched to run 
on systems with different search drives. Since it needs to know 
what drive this is, it is set up as a patchable parameter. Thus, 
most of Turbo-Plus's modules are distributed as relocatable 
(.EEL) files, so that parameters may be 'plugged in' in the 
installation procedure using the TurboDOS symbolic patch facility 
described in the Configuration Guide to TurboDOS . 

Section Z of this guide briefly describes all of the modules 
sent as part of the Turbo-Plus package, and explains where on the 
system they should be placed. 

Section 3 describes the installation procedure for 
generating a customized version of Turbo-Plus excluding the 
background batch processor, which involves some extra steps. 

Section 4 describes the installation procedure for the 
background batch processor. 
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Overview 

Turbo-Plus makes extensive use of the TurboDOS Uses Defined 
Function (TurboDOS call 29H) and follows the USRSUP calling 
protocol, outlined in your TurboDOS 1.41 update notes, and in 
Appendix C of this manual. Therefore, if you wish to add your own 
functions with this call, it is imperative that you also follow 
the USRSUP protocol, which has been adopted by Software 2000 as 
the standard TurboDOS method. 



Serialization 

Each copy of Turbo-Pius is serialized to be run only on a 
particular TurboDOS operating system. The serial number must 
agree with that of the operating system on which it is to be run. 
None of the modules in Turbo-Plus will run on any system with a 
sarial number different that its own. 
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Turbo-Plus Installation 
Check List 

THIS CHECKLIST IS FOB PUBE 8 BIT INSTALLATIONS ONLY 

[ ] 1. Bead the Turbo-Plus Installation Guide. 

[ ] 2. Bun INSTALL.COM. 

This program will ask questions about your TurboDOS 
version, and your SYSTEM BOOT drive and SEABCH drive. 
It will then create the proper .PAB files for your 
configuration and proceed to GEN the Turbo-Plus 
modules. When GEN is complete, it will copy all of the 
appropriate files to their correct destinations en your 
system. 

[ ] 3. Bun BBINSTAL.COM ! OPTIONAL! 

If you desire to use the Background Batch commands, it 
will be necessary to run this installation program. 
BBINSTAL will ask the same questions as above and in 
addition will require a particular user area 
designation where it can reside when idle and maintain 
it's files. 

[ ] 4. COPY all help ( .HLP) files from Distribution Disk(s) 
to user of your search drive. 

[ ] 5. COPY TPLUSS.BEL, TPLUSM.BEL, C0N96TP.BEL, CONBB.BEL, 
TWXTV.EEL and TWXNUL.EEL to the area of your disk where 
you generate your TurboDOS systems. 

[ ] 6. GEN all Slaves - Be sure that each OSSLAVEx.GEN 
includes C0N96TP.BEL (replacing your existing 
C0N96.EEL), TPLUSS.BEL and TWXTV.BEL (or TWXNUL.EEL), 
as well as USBSUP.EEL, NETSVC.EEL and NETFWD.BEL (all 
supplied by Software 2000, Inc., but not generally 
included in slave generation). 

[ ] 7. GEN Background Batch slave. ! OPTIONAL! 

[ ] a. In order to allow the BATCH PBOCESSING slave to recover 

from console input conditions (illegal in BB), 

substitute CONBB.BEL for C0N96TP.BEL on the 

OSSLAVEx.GEN designated in the BBINSTAL session. 

[ ] b. Include LOGUSE = NN (where NN = user area specified in 
BBINSTAL - i.e. LOGUSB = IE for area 30) in this 



OSSLAVEx.PAE file. 



(Cont'd) 
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[ ] 8. GEN the Master (OSMASTER. SYS) . 

Be sure to include TPLUSM.REL as well as USRSUP.REL, 
NETFWD.REL, NETREQ.REL and MSGPMT.REL (supplied by 
Software 2000, Inc.) in the OSMASTER. GEN file. 

[ ] 9. Reset and test your system. You should first notice 
the new Turbo-Plus LOGON program if everything is 
properly installed. 
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Turbo-Plus Modules 



Turbo-Plus will arrive on two CP/M format single-sided 
single-density diskettes. One of these disks will be a "flippy", 
giving you a total of three disk sides. Side one contains all of 
the relocatable modules; side two contains .DO. .GEN. and .PAE 
files used to generate your Turbo-Plus installation; side three 
contains all of the .HLP files necessary for the HELP command. 

Program Modules 

Side one contains three types of files: 

1) Relocatable program files: 

Those files which constitute the main bodies of the 
Turbo-Plus utility programs. 

2) Relocatable subroutine files: 

Those files which contain subroutines called by the 
programs above. 

3) System function files: 

Files containing extensions to the normal set of 
TurboDOS operating system calls which must be genned 
into the operating system. 

Side two contains all of the supporting files used for 
generating your installed version of Turbo-Plus. This includes 
.GEN and .PAR files for your programs, auxiliary data files, two 
installation .COM files, and .DO files referenced by the install 
programs . 

Side three contains the text files (????????. HLP) for the 
HELP utility. All of these files should be moved to user of the 
system search drive. 
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Relocatable and executable program files 

These are all of the files containing the assembled source 
code for the Turbo-Plus utilities. They are distributed in 
relocatable form, to allow the patching of parameters. 



DIBDUMP.BEL 
GO.REL 
GONAMB . EEL 
HELP . EEL 

LOCATE . SEL 
LOG BEL 
LOGOFF , EEL 
LOGON. BEL 

MAIL. EEL 

MASTEE.EEL 

PEOPILE.EEL 
BESET . BEL 
STATUS . BEL 

TWX.BEL 

USEE. EEL 

WHO. EEL 



Program which gives a master directory of any disk, 
sorted by user area. 

Program which moves users to a user area specified 
by a user-defined name. 

Utility which allows users to define names for user 
areas on the system. 

TurboDOS on-line help facility providing help on 
all TurboDOS and Turbo-Plus commands. Users may 
add thsir own help files. 

Utility to search certain or all system drives for 
given file or template. 

Utility to make entries in a date and time stamped 
log file. 

Enhanced version of system logoff, notifying users 
of pending mail, and displaying system bulletins. 

Enhanced version of system logon, notifying users 
of pending mail, displaying system bulletins, and 
providing additional levels of security. 

TurboDOS mail facility to allow electronic mail to 
be sent among users on the system. 

Enhanced version of the TurboDOS 'MASTEB' command, 
providing better control of access to the master. 

Program to maintain USEEID.SYS file. 

Program to reset a slave from another slave. 

Facility to continuously monitor activity of system 
users, printers, and buffers. 

TWX facility to allow users to send immediate 
messages to other consoles on the system. 

Allows user to change user areas. Performs the 
same function as the TurboDOS USEE command of 
versions 1.3 and earlier. 

System status facility to display all current users 
on the system, processes they are running and other 
current system characteristics. 
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Relocatable subroutine files 

A number of routines are shared by various program modules 
include the following files: 



They 



DBUFF . RBL 
MBUFF . EEL 



GBUFF . EEL 
MEOUTE.REL 
TPMOD . REL 



LOGCHK.REL 
PTABLE.REL 
TPSCAN.REL 



LOGDAT . REL 
TABLES . REL 



System function files 

These files must be moved to the user area on the system where 
your system's .GEN and .PAR files reside, and where your system 
generation takes place. Some of them must be genned into your 

M«^n4-Aw> * — . <*.»>a>*_ « _ _. m.- _n_ _ tii a _ %- 

ojfouoiu xi-i ux-u.or iui- iuruo~riU8 i»o WO I'A . 

files, all on disk 1: 



mere are 



six sucn 



TPLUSS.REL 
TWXNUL . REL 
C0N96TP . REL 



TPLIJSM.REL 

TWXTV.REL 

CQNBB.REL 



.GEN and .PAR files 

These files are necessary to patch the modules to work under your 
system configuration. 



All of the following programs have .GEN files, 
accompanied by .PAR files: 



some of which are 



DIRDUMP 


GO 


GONAME 


HELP 


LOCATE 


LOG 


LOGOFF 


LOGON 


MAIL 


MASTER 


PROFILE 


RESET 


STATUS 


TWX 


USER 


WHO 



The following files are necessary for the installation procedure: 

TPLUS . DO INSTALL . COM 
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Installing Turbo-Plus 

Generating executable programs 

Before you begin your Turbo-Plus installation, make a backup 
of the distribution diskette(s) If w ou received Turbo— Plus on a 
single TurboDOS format disk, you may run the install procedure 
directly from that disk. If not, you must copy the first two 
disks onto any user area on the system other than user zero of 
the search drive. 

To customize Turbo-Plus to your system configuration, 
execute the INSTALL command. This program will prompt you for 
your TurboDOS version number, system search drive and the drive 

wuiviii wui'i'oumjF uuuuaxuo $\ju.i: o^oiiciu uuu i» uxoa. mu xiu i» luCiudc 

the colon after the drive letters); all of the necessary .COM 
files will be generated and moved down to the search drive. 
Then, all of the .HLP files should be moved from the distribution 
disk to user zero of the search drive. During execution of the 
INSTALL process, it is very possible that Certain stages will 
return with system error messages such as 'Pile not found' . This 
is due to the fact that the procedure must make sure that if any 
of these programs were already present, in an older version, they 
are deleted. Thus, if the programs were not there, trying to 
delete them will yield error messages. 

Note: If you do not have a system search drive, you must 
still give some drive parameter to be used by Turbo-Plus as the 
drive on which to maintain all of its files. 
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System Generation 

Before Turbo-Plus may be brought up, it is necessary to 
generate a new operating system. You should start with the .GEN 
and .PAR files which you are currently using for both your 
slave(s) and your master, but some additions will be necessary. 

Generating a new system master 

The following changes must be made to the .GEN file for your 
system master (usually STDMASTR.GEN or OSMASTER.GEN) . Using your 
system editor, insert the following lines after the line for the 
hardware initialization, 

TJSRSUP 
TPLTJSM 

The following three lines, containing modules which are 
supplied by Software 2000, but not generally included in the 
master configuration, should also be added after STDMASTR: 

NETFWD 
NETBEQ 
MSGPMT 

If you have the ability to use the TWX and RESET commands, 
it is recommended that you use modified circuit drivers. Many 
existing circuit drivers have already been modified 
appropriately; if your dealer says that yours has not been, a 
revision will be necessary. There should be no change made to 
the master circuit driver, and the source for your slave circuit 
driver should be changed, following the instructions in Appendix 
A. 

Certain functions performed by Turbo-Plus utilities call for 
routing tables to be set up in the master. Turbo-Plus handles 
these changes automatically for single-circuit systems, but if 
you are utilizing more than one circuit in your system, (i.e. two 
or more types of slave boards) you will also need to add a Turbo- 
Plus slave table to your master .PAR file. If this is the case 
for your system, please refer to Appendix B for instructions on 
creating this table. 

Figure 3.1 shows a sample OSMASTER.GEN file prepared for 
Turbo-Plus . 
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STDMASTR 

NETBEQ 

MSGFMT 

NETFWD 

HDWNIT 

USBSUP 

TPLUSM 

CONREM 

LSTPAR 

LSTETX 

LSTTAB 

SPDXXX 

BRTXXX 

RTCXXX 

DSKXXX 

DST58F 

DSKHHH 

MCDXXX 



Figure 3.1 
Sample OSMASTER.GEN file 

STANDARD NETWORK MASTER CONFIGURATION 
NETWORK REQUEST PROCESSOR 
NETWORK MESSAGE FORMAT TABLE 
NETWORK MESSAGE FORWARDING 

HARDWARE INITIALIZATION 
USER FUNCTION INTERFACE 
TURBO-PLUS FUNCTION EXTENSIONS 

REMOTE MASTER CONSOLE 

DRIVER FOR HIGH SPEED PRINTER 

DRIVER FOR LETTER QUALITY PRINTER 

DRIVER FOR HIGH SPEED PRINTER EXPANDING TABS 

SERIAL & PARALLEL DRIVERS 

BAUD-RATE TABLES 

REAL-TIME CLOCK DRIVER 

FLOPPY DISK DRIVER 

FLOPPY DISK SPECIFICATION TABLES 

HARD DISK DRIVER 

DRIVER 



Figure 3.2 
Sample OSMASTER.PAR file 



COMPAT 


= 


OFO 


NMBSVC 


= 


9 


NMBXXX 


= 


9 


NMBMBS 


= 


IB 


NMBUFS 


= 


10 


NMBRPS 


= 


IB 


PATXXX 


= 


60, 



Compatibility flags 

Number of slaves 

Number of slaves (9) 

Number of message buffers (27) 

16 I/O buffers 

Number of network reply packets 



(27) 



60 , 62 , 64 , 66 , 68 , 6A, 6C , 6E, 70 , 72 , 74 , 76 , 78 , 7A, 7C , 7E 

; Slave Port assignment table 
DSKAST = 00,DSKDRA,01,DSKDRA,00,DSKDRB,01,DSKDRB,02,DSKDRB,03,DSKDRB t 
04 , DSKDHB , 05 , DSKDRB , 06 , DSKDRB , 07 , DSKDRB , 08 , DSKDRB , 09 , DSKDRB f 
A , DSKDRB , OB , DSKDRB 

Disk assignment table: 
A,B = floppy drives 
C-N = Winchester disk 
PTRAST = 00,LSTDRA,01,LSTDRB,00,LSTDRC 

Printer assignment table: 

A = High speed with raw output 
B = Letter quality with raw output 
C = High speed w/ formatted output 
Reserved memory above TPA 



MEMRES 
DSPPAT 



AUTUSR 
QUEAST 

SRHDRV 
ETXBR = 



= (1000) 

= 1,2,0,0,0,0,0,0,0,0,0 

De-Spool table: 



■ 80 
= 00 

•■ 8 
OE 



(0), 00,(0), 00 



Printer A — > Queue A 

Printer B — > Queue B 
Log master on to user 0, privileged 
(0), 00,(0), 00,(0), 00,(0), 00,(0), 00,(0) 
Define eight valid queues (A-H) 
System search drive = H 
Baud rate on Printer B = 9600 
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Generating new slaves 

Next, in your slave .GEN files, add lines containing USHSTJP 
and TPLUSS following the hardware initialization module. Also 
include NET SVC and NETFWD immediately after the line for 
STDSLAVE. Also, to optimize the performance of the TWX command, 
you need a special console driver, modified circuit drivers, and 
a separate module to handle the shift-in shift-out produced by 
TWX. 

If your standard console driver is C0N96, you may use the 
C0N96TP driver provided with Turbo-Plus. (To do so, simply 
replace the C0N96 line in your .GEN file with CON96TP) . If not, 
you should modify your driver such that before every console 
output, it performs a WAIT operation on the global semaphore: 
TWLOCK, and after each console output, it performs a SIGNAL 
operation on the same semaphore. It should also allow for a 
character to remove the TWX message from the 25th line of the 
screen, by calling the external routine TWXRST when this 
character is received. C0N96TP uses the ESC character by 
default, and if there is no message on the status line, it allows 
the escape to passed through normally. Figure 3.5 shows the 
C0N96TP driver, which may be used as a guideline. 

Furthermore, for those of you using TWX and RESET, your 
circuit driver may require modification. Consult appendix A for 
the necessary changes. 

The second module necessary for TWX handles the placing of 
TWX messages on the screen without interrupting normal console 
input/output. If you are using a Televideo terminal, you may use 
the TWXTV module, which places all received TWX messages on the 
terminal status line. For any other terminal you may use the 
TWXNDL module, which simply prints each line at the current 
cursor position, followed by a carriage return-line feed 
sequence. A source listing of this module is provided and 
explained in Figure 3.6, in case you wish to modify it for your 
specific terminal. Modification may be done either by writing 
your own driver, or patching TWXNUL in the slave .PAR file. 

Figure 3.4 shows a sample slave .GEN file and figure 3.3 
shows the corresponding .PAR file. 

Once all of these changes are complete, you are ready to 
generate the new master and slaves using the GEN command in the 
usual way. (Refer to the TurboDOS configuration Guide.) Once all 
of these steps are done, copy the newly created .SYS files down 
to user zero of your boot disk, and Turbo-Plus will be ready to 
come up. 
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Figure 3.3 
Sample STDSLAVE.PAE file 



COMPAT 


= 


OFO 


SEHDRV 


= 


8 


PRTMOD 


= 


01 


QUEPTR 


= 


1 


SPLDRV 


= 


8 



File Compatibility flags 
System search drive = H 
Print mode ■ Spooled 
Default Queue = A 
Spool Drive ■ I 



STDSLAVB 

"KTTjim OT1Y! 
£% ill XUfV 

NETFWD 

NITXXX 

USRSUP 

TPLUSS 

CQN96TP 

TWXTV 

SPDXXX 

SLVRES 

SCDXXX 



Figure 3.4 
Sample STDSLAVE . GEN file 

STANDARD NETWORK SLAVE CONFIGURATION 

*TnnnT.Tr\"DV" ouuTTTma Tvonniaoo 
iwinwxiA Dnaviu£i xawuciod 

NETWORK MESSAGE FORWARDING 

HARDWARE INITIALIZATION 

USER FUNCTION CALLING MODULE 

TURBO-PLUS FUNCTION EXTENSIONS 

TURBO-PLUS ASCII CONSOLE AT 9600 BAUD 

TWX CONSOLE MANAGER FOR TELEVIDEO 950/925/800 

SERIAL & PARALLEL DRIVERS 

SUBROUTINE FOR KEYBOARD RESET OF SLAVE 

SLAVE CIRCUIT DRIVER 



Special hardware-dependent modules, 
above, are in boldface. 



described in the paragraphs 
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Figure 3.5 
Sample Turbo-Plus Console Driver 

C0N96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 



0000" 



0000' 



; COPYRIGHT (C) 1982, SOFTWARE 2000, INC 

; AUTHORS: RONALD E. RAIKES 
; MICHAEL D. BUSCH 



VERSION: 01/20/82 

Edit History: JBG 
JBG 
JBG 
JBG 
JBG 
JBG 

IDENT C0N96T 

INSERT DREQUATE 

.LOG .DATA.# 



18-Jan-83 
Jun-83 
9-Nov-83 
17-Jul-84 
28-Sep-84 
30-Nov-84 



TWX MX-Locks ins 
Control code loc 
1.30 Optimized o 
Optimized output 
Included with. V. 
Clear status lin 



00C0" 


8E 


CONBR: : 


.BYTE 


8EH 


0001" 


OC 


FFCHR: : 


.BYTE 


AFF 


0002" 




R25CHR: : 






0002" 


IB 




.BYTE 


1BH 


0003" 


00 


INITG: 


.BYTE 





0004" 


00 


EFLAG : 


.BYTE 





0005 ,; 


00 


BCOUNT : 


.BYTE 





0006' 


000 ( 


SGOUNT: 


.WORD 






LOC 



PROG . # 



0000' 


21 0003" 


CONDR%: :LZI 


H.INITC 


0003' 


7E 


MOV 


A,M 


0004' 


B7 


ORA 


A 


0005' 


CC 0106' 


CZ 


CNINIT 


0008' 


7B 


, .CDRV: MOV 


A,E 


0009' 


D608 


SUI 


8 


000B' 


CA 0123' 


JZ 


CONSO 


000E' 


3D 


DCR 


A 


000F' 


CA 0123' 


JZ 


CONS I 


0012' 


3D 


DCR 


A 


0013' 


CA 0129' 


JZ 


OPT 


0016' 


7B 


MOV 


A,E 


0017' 


B7 


ORA 


A 


0018' 


2838 


JRZ 


CONST 


001A' 


3D 


DCR 


A 


001B' 


2807 


JRZ 


CONIN 



; MODULE ID 

; DRIVER SYMBOLIC EQUIVA 

; LOCATE IN DATA AREA 

; CONSOLE BAUD RATE CCgP 
; FORM FEED CHARACTER li 

; RESTORE 25TH LINE CHAB 
; INITIALIZATION COMPLET 



LOCATE IN PROGRAM AREA 

; GET INITIALIZATION COM 



INITIALIZATION COMPLET 
IF NOT, INITIALIZE COK 
GET FUNCTION NUMBER 
FUNCTION NUMBER=8? 
IF SO, ERROR SHIFT OUT 
FUNCTION NUMBER=9? 
IF SO, ERROR SHIFT IN 
FUNCTION NUMBER = 10? 
IF SO, JUMP TO OPTIMIZ 
GET BACK IN A 
IF 0, GO TO CONSTAT 

IF 1, CONIN 
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C0N96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 



001D' 


3D 






001E' 


CA 


00A6' 




0021' 


C3 


0000: 


04 


0024' 








0024' 


3A 


0004' 




0027' 


B7 






0028' 


CA 


002F' 




002B' 


AF 






002C 


CD 


0093' 




002F' 








uu6r 








0030' 


D5 






0031' 


CD 


0000: 


04 


0034' 


F5 






0035' 


E67F 




0037' 


TE 1 






0038' 


3A 


0002' 




003B' 


B8 






003C 


C2 


004E' 




003F' 


3A 


0000: 


05 


0042' 


B7 






0043' 


2809 




0045' 


CD 


0000: 


06 


r^48' 


Fl 






U)49 ' 


Dl 






004A' 


CI 






004B' 


C3 


0000: 


04 


004E' 








004E' 


Fl 






004F' 


Dl 






0050' 


CI 






0051' 


C9 






0052' 








0052' 


3A 


0004' 


» 


0055' 


B7 






0056' 


CA 


0067' 




0059' 


E5 






005A' 


2A 


0006' 


» 


005D' 


23 






005E' 


22 


0006' 


» 


0061' 


7C 






0062' 


B5 






0063' 


CC 


0093' 




0066' 


El 






0067' 








0067' 


C5 






0068' 


CD 


0000: 


04 


006B' 


Dl 






06C 


B7 







CONIN: 



SER: 



RET: 



CONST 



. .SER: 



DCR 


Xa. 


JZ 


CONOUT 


JMP 


SERIAL# 


LDA 


EFLAG 


ORA 


A 


JZ 


. .SER 


XRA 


A 


CALL 


RELEAS 


TITTflTT 

ruon 




PUSH 


D 


CALL 


SERIAL# 


PUSH 


PSW 


ANI 


7FH 


MOV 


B,A 


LDA 


R25CHR 


CMP 


B 


JNZ 


. .RET 


LDA 


LINE25# 


ORA 


A 


JRZ 


. .RET 


CALL 


TWXRST# 


POP 


PSW 


POP 


D 


POP 


B 


JMP 


SERIAL# 


POP 


PSW 


POP 


D 


POP 


B 


RET 




LDA 


EFLAG 


ORA 


A 


JZ 


. .SER 


PUSH 


H 


LHLD 


SCOUNT 


INX 


H 


SHLD 


SCOUNT 


MOV 


A,H 


ORA 


L 


CZ 


RELEAS 


POP 


H 


PUSH 


B 


CALL 


SERIAL# 


POP 


D 


ORA 


A 



IF 2, CONOUT 

****** 



IF ESCAPE FLAG IS NOT 

JUST GO TO SERIAL, ELS 
RESET FLAGS AND SEMAPH 



*"1 ft 1 > T! I ^l^T A V»TKIT mi l l *.*** l.l lt 

OAVJ5 onANwjajj NunBrixi 

AND FUNCTION NUMBER 

GET THE CHARACTER 

SAVE IT 

STRIP PARITY 

SAVE IT 

COMPARE TO 25TH LINE B 

IF SO 

CHECK FOR PRESENCE 

IF NONE, SKIP THIS 
RESTORE THE LINE 
GET REGISTERS OF TH 
. BECAUSE WE NEED T 
. AND THE CHANNEL I 
GO AHEAD TO SERIAL# 

ELSE 

GET CHAR BACK IN A 
RESTORE THE STACK 

ENDIF 

RETURN 



IF ESCAPE FLAG IS NOT 

JUST GO TO SERIAL, ELS 

SAVE HL 

CHECK CON STAT COUNT 

BUMP IT 

SAVE NEW STAT COUNT 

IF 0, RELEASE ESCAPE F 



RESTORE HL 

SAVE CHANNEL NUMBER 
AND GO TO SERIAL 
GET CHANNEL NUMBER BAC 
IF NOTHING AVAILABLE, 
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006D 


C8 






RZ 




006E 


F5 






PUSH 


PSW 


006F 


C5 






PUSH 


B 


0070 


79 






MOV 


A,C 


0071 


E67F 




ANI 


7FH 


0073 


47 






MOV 


B,A 


0074 


SA 


0002" 




LDA 


R25CHR 


0077 


B6 






CMP 


B 


00? 8 


v«5 


0090 ' 




JNZ 


. .RST 


007B 


3A 


0000:08 




LDA 


LINE25# 


007E 


B7 






ORA 


A 


007F 


280F 




JRZ 


. .RST 


0081' 


CD 


0000:06 




CALL 


TWXRST# 


0084 


42 






MOV 


B,D 


0085' 


1E01 




MVI 


E,l 


0087 ' 


CD 


0000:04 




CALL 


SERIAL# 


008A' 


CI 






POP 


B 


008B' 


Fl 






POP 


PSW 


008C 


AF 






XRA 


A 


008D ] 


C3 


0092' 




JMP 


, .RET 


0090 ' 






. . RST : 






0090 ' 


CI 






POP 


B 


0091 


Fi 






POP 


PSW 


0092' 






. .RET: 






0098 


09 






RET 




0093' 






RELEAS : 






0093 


32 


0004" 




STA 


EFLAG 


0096 


32 


0005" 




STA 


BCOUNT 


0099' 


C5 






PUSH 


B 


009A' 


D5 






PUSH 


D 


009B' 


E5 






PUSH 


H 


009C 


21 


0000:07 




LXI 


H,TWLOCK# 


009F 


CD 


0000:08 




CALL 


SIGNAL# 


00A2 


El 






POP 


H 


00A3 


Dl 






POP 


D 


00A4 


CI 






POP 


B 


00A5 


C9 






RET 




00A6 






CONOUT : 






00A6 


3A 


0004" 




LDA 


EFLAG 


00A9 


B7 






ORA 


A 


OOAA 


280E 




JRZ 


. .NSEQ 


OOAC 


3A 


0005" 




LDA 


BCOUNT 


OOAF 


3D 






DCR 


A 


OOBO 


32 


0005" 




STA 


BCOUNT 


00B3 


2024 




JRNZ 


. . CONT 


00B5 


32 


0004" 




STA 


EFLAG 


00B8 


181F 




JMPR 


. . CONT 


OOBA 






. . NSEQ : 






OOBA 


79 






MOV 


A.C 



SAVE REGISTERS FOR RET 



STRIP PARITY 

SAVE IT 

COMPARE TO 28TH LINE B 

IF SO 

CHECK FOR PRESENCE 

IF NONE, SKIP THIS 
RESTORE THE LINE 
GET CHANNEL NUMBER 
CEALL CONIN TO FLUS 

GET REGISTERS OFF S 

FLAG NO CHARACTER A 
ELSE 

RESTORE REGISTERS N 

ENDIF 
RETURN 



SAVE REGISTERS 

RELEASE CONSOLE 

RESTORE REGISTERS 

ENDIF 
RETURN 

IF WE ARE IN THE MIDDL 



GET BYTE COUNTER 
DECREMENT IT 
STORE IT 
IF IT'S ZERO 

TURN OFF ESCAPE 
ENDIF 
ELSE 

GET BYTE IN A 
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OOBB' 


E67F 




ANI 


7FH 


OOBD' 


FE1B 




CPI 


1BH 


OOBF' 


200C 




JRNZ 


. .NESC 


00C1' 


F8FF 




ORI 


OFFH 


00C3' 


32 


0004* 




STA 


EFLAG 


00C6' 


3C 






INR 


A 


00C7' 


32 


0006' 




STA 


SCOUNT 


OOCA' 


32 


0007' 




STA 


SCOUNT+1 


OOCD' 








. .NESC: 




OOCD' 


C5 






PUSH 


B 


OOCE' 


D5 






PUSH 


D 


OOGF ' 


E5 






PUSH 


H 


OODO' 


21 


0000: 


07 


LXI 


H,TWLOCK# 


0003' 


CD 


0000: 


09 


CALL 


WAIT# 


00D6' 


El 






POP 


H 


00D7' 


Dl 






POP 


D 


00D8' 


CI 






POP 


B 


00D9' 








. .CONT: 




00D9' 


79 






MOV 


A,C 


OODA' 


E67F 




ANI 


7FH 


OODC 


FE1B 




CPI 


1BH 


OODE' 


2011 




JRNZ 


. .NE2 


OOEO' 


3E06 




MVI 


A, 6 


00E2' 


32 


0005' 




STA 


BCOUNT 


^*)E5' 


F6FF 




ORI 


OFFH 


32 


0004' 




STA 


EFLAG 


OOEA' 


3C 






INR 


A 


OOEB' 


32 


0006' 




STA 


SCOUNT 


OOEE' 


32 


0007' 


► 


STA 


SCOUNT+1 


00F1' 








. .NE2: 




00F1' 


CD 


0000: 


04 


CALL 


SERIAL# 


00F4' 


3A 


0004' 


r 


LDA 


EFLAG 


00F7' 


B7 






ORA 


A 


00F8' 


CO 






RNZ 




00F9' 


C5 






PUSH 


B 


OOFA' 


D5 






PUSH 


D 


OOFB' 


E5 






PUSH 


H 


OOFC 


21 


0000: 


07 


LXI 


H,TWLOCK# 


OOFF' 


CD 


0000: 


08 


CALL 


SIGNAL# 


0102' 


El 






POP 


H 


0103' 


Dl 






POP 


D 


0104' 


CI 






POP 


B 


0105' 


C9 






RET 




0106' 


35 






CNINIT: DCR 


M 


0107' 


D5 






PUSH 


D 


0108' 


C5 






PUSH 


B 


0109' 


3A 


0000" 


LDA 


CONBR 


010C 


4F 






MOV 


C,A 


010D' 


1E03 




MVI 


E,3 


nOF' 


CD 


0000: 


04 


CALL 


SERIAL# 



CHECK FOR ESCAPE 
IF ESCAPE 
SET FLAG 



AND INITIALIZE S 

ENDIF 

SAVE REGISTERS 



WAIT FOR CONSOLE FRE 
RESTORE REGISTERS 

END IF 

GET BYTE IN A 

STRIP PARITY 

IF IT'S AN ESCAPE 

INITIALIZE BYTE COU 

SET FLAG 

AND INITIALIZE STAT 



ENDIF 

PRINT THE BYTE 
CHECK ESCAPE FLAG 
IF IT WAS NOT SET 

SAVE REGISTERS 



RELEASE CONSOLE 

RESTORE REGISTERS 

ENDIF 
RETURN 

SET INITIALIZATION COM 
SAVE FUNCTION NUMBER 
SAVE CHANNEL NUMBER/CH 
GET CONSOLE BAUD RATE 
TELEVIDEO BAUD RATE CO 
SET FUNCTION NUMBER=3 
SET CHANNEL BUAD RATE 



3-9 



Turbo-Plus VI. 41 8-bit Installation Guide 



C0N96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 



0112' 


3A 0001" 




LDA 


FFCHR 


0115' 


B7 






ORA 


A 


0116' 


2808 






JRZ 


. .NITX 


0118' 


01 






POP 


B 


0119' 


05 






PUSH 


B 


011A' 


4F 






MOV 


C,A 


011B' 


1^02 






MVI 


E,2 


OliD' 


OD 0000: 


04 




CALL 


SERIAL# 


0120 


CI 




. .NITX: 


POP 


B 


0121 


Di 






POP 


D 


0122' 


09 






RET 




0123' 






CONSO: 






012^' 


CD 0000: 


OA 


CONS I: 


CALL 


DMS# 


0126 5 


0D8A 






.ASCIS 


[ACR] [ALF] 


0128' 


C9 






RET 




0129 s 






OPT: 






0129' 


3A 0000: 


07 




LDA 


TWLOCK# 


012C 


B7 






ORA 


A 


012D' 


C6 






RZ 




012E' 


3A 0004' 


! 




LDA 


EFLAG 


0131 s 


B7 






ORA 


A 


0132' 


2802 






JRZ 


. .NSEQ 


0134' 


AF 






XRA 


A 


0135' 


CQ 






RET 




0138' 






. . NSEQ : 






0136' 


79 






MOV 


A,C 


0137' 


E67F 






ANI 


7FH 


0139* 


D61B 






SUI 


AESC 


013B' 


08 






RZ 




0133' 


03 DODO 


04 




JMP 


SERIAL# 



GET FORM FEED CHARACTE 
FORM FEED CHARACTERS? 
IF SO, CONTINUE 
ELSE, RESTORE CHANNEL 
SAVE CHANNEL NUMBER 
FORM FEED CHARACTER TO 
SET FUNCTION NUMBERS 
OUTPUT FORM FEED 
RESTORE CHANNEL NUMBEB 
RESTORE FUNCTION NDMBE 
DONE 



; POSITION TO NEXT LINE 
; DONE 



LOOK AT TWX LOCK 

IF IN USE, RETURN U 

ELSE, IF IN MIDDLE OF 



RETURN UNSUCCES 
ELSE IF THE CHARACTER 

RETURN UNSUCCESSFUL 
ELSE, JUST DO THE OUTP 



END 
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Figure 3.6 
TWX Null Console Manager 



JXNUL - Turbo-Plus TWXNUL driver 



0000" 

0000" 
0000" 
0001" 
0001" 
000B" 

COOB" 
015" 
0015" 

0000' 
0000' 
0000' 
0001' 
0002' 
0003' 
0004' 
0007' 

0009' 
0009' 
000A' 
000B' 
000C 
000D' 
000F' 
0012' 
0015' 

0017' 
0017' 
0018' 
^019' 



00 

ODOAOOOOOOOO 
ODOAOOOOOOOO 
000000000000 



F5 

C5 

D5 

B5 

21 0001 

1819 



F5 

C5 

D5 

E5 

F6FF 

32 0000' 

21 OOOB 1 

180B 



F5 
C5 
D5 



Shi ft- In/ Shift-Out controls for null console 
AUTHOR: Jim Gabriel 



Revised for Turb 
Revised for Turb 
Equates changed 
Clear status lin 



Microserve, 


Inc . 


Edit History: JBG : 


24-Aug-83 


JBG : 


24-Jul-84 


JBG : 


28-Sep-84 


JBG : 


30-Nov-84 



I DENT TWXNUL 



INSERT 
INSERT 



LINE25 
SI CODE 
SOCODE 
RSTCOD 

TWXSI: 



DREQUATE 
TEQUATE 

.LOG 



TWXSO: 



TWXRST: 



.BYTE 

.BYTE 

.BYTE 

.BYTE 

.LOC 

PUSH 

PUSH 

PUSH 

PUSH 

LXI 

JMPR 



PUSH 

PUSH 

PUSH 

PUSH 

ORI 

STA 

LXI 

JMPR 



PUSH 
PUSH 
PUSH 



. DATA . # 



ACR, ALF ,0,0,0,0,0,0,0,0 
ACR, ALF, ,0,0,0,0,0,0,0 
0,0,0,0,0,0,0,0,0,0 
. PROG . # 



PSW 

B 

D 

H 

H,SIC0DE 

SCONT 



PSW 

B 

D 

H 

OFFH 

LINE25 

H, SOCODE 

SCONT 



PSW 

B 

D 



; SAVE REGISTERS 

SET HL FOR SHIFT IN 

; SAVE REGISTERS 

SIGNAL THAT A MESSAGE 
SET HL FOR SHIFT OUT 

; SAVE REGISTERS 
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001A 


E5 




PUSH 


H ; 


001B 


AF 




XRA 


A ; 


001C 


32 0000" 




STA 


LINE25 ; 


001F 


21 0015" 




LXI 


H.RSTCOD ; 


0022 




SCONT : 






0022 


3A 1000:04 




LDA 


CONAST# ; 


0025 


5? 




MOV 


D,A ; 


0026 




CLOOP: 






0028 


7B 




MOV 


A,M j 


0027 


B7 




ORA 


A ; 


0028 


2805! 




JRZ 


SRET ; 


002A 


5F 




MOV 


E,A ; 


002B 




CMOUTO : 


: 




002B 


0B24 




MVI 


C , 24H | 


002D 


D5 




PUSH 


D ; 


002E 


E5 




PUSH 


H ; 


002F 


AF 




XRA 


A ; 


0030 


CD 00u0:05 




CALL 


XTNTRY# ; 


0033 


El 




POP 


H ; 


0034 


Dl 




POP 


D 


0035 


23 




INX 


H ; 


0036 


18EB 




JMPR 


CLOOP ; 


0038 


El 


SRET: 


POP 


H ; 


0039 


Dl 




POP 


D 


003A 


CI 




POP 


B ; 


003B 


Fl 




POP 


PSW ; 


0C3C 


C9 




RET 





SIGNAL THAT NO MESSAGE 

SET HL FOR SHIFT OUT 

GET CONSOLE CHANNEL IK 

FOR EACH BYTE DO 
GET BYTE IN E 



SET PARM FOR CONOUT 
SAVE CHANNEL NUMBEE 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 



RETURN 



.END 
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To modify this driver you may either write your own, or use 
the symbolic patch facility. The primary reason to write your 
own would be to perform operations other than a simple console 
output of a string of bytes, such as code to also keep track of 
the cursor position before the message. 

If you wish to do this, the module must meet the following 
specifications; It must have the global entry points TWXSI, 
which will be called before every TWX line, to position the 
cursor as desired; TWXSO, which will be called after every TWX 
line, to restore the cursor; and TWXRST, which will be called to 
remove the TWX message from the 25th line. All console output 
must be done via calls to the comm channel, which is defined in 
register D upon entry to the routine. 

If wqup osl v modifications involve ohan tf in tf the string of 
bytes to be sent out before and after each message, it will 
probably be more convenient to use the TurboDOS symbolic patch 
facility. The routine allows for up to ten bytes to be patched 
at locations SICODE, SOCODE, and ESTCOD for the sequences to be 
sent out before the message, after the message, and to remove the 
message respectively. For example, if you wish to send out five 
bells and a clear screen at the beginning, five bells and a 
carriage return-line feed sequence at the end, and an ESCAPE, 
control-G sequence to remove the message, your .PAH file for the 
slave could be patched as follows, using TWXNUL: 

SICODE ■ 07,07,07,07,07,00 
SOCODE = 07,07,07,07,07,0D,0A 
ESTCOD = IB, 07 

However, if you are using one type of terminal frequently, 
it may be easiest to write a special driver for it, even if it 
only involves changing the bytes, so that you need not change 
every .PAE file which you use. An example of such a driver is 
TWXTV, shown in Figure 3.7, written for the Televideo 800, 925, 
and 950 terminals. This driver is designed to take advantage of 
the status line of the terminal. All TWX messages will appear on 
this line, leaving the user's screen intact. 
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Figure 3.7 
TWX Televideo Console Manager 

TWXTV - Turbo-Plus TWXTV driver 
Microserve, Inc. 



0000" 

0000" 
0000" 
0001" 
0001" 
000B" 
000B" 
0015" 
0015" 

0000' 
0000' 
0000' 
0001' 
0002' 
0003' 
0004' 
0007' 

0009' 
0009' 
000A' 
000B' 
000C 
OOOD' 
OOOP' 
0012' 
0015' 

0017' 
0017' 



00 

071B671B661B 
ODOOOOOOOOOO 
1B6800000000 



F5 

C5 

D5 

E5 

21 0001 

1819 



P5 

C5 

D5 

E5 

F6FF 

32 0000" 

21 OOOB" 

180B 



F5 



Shift-In/Shift-Out controls for Televideo 925/95 

AUTHOR: Jim Gabriel 

Microserve, Inc . 



Edit History: JBG 
JBG 
JBG 
JBG 



24-Aug-83 
24- Jul -84 
28-Sep-84 
30-Nov-84 



Revised for Turb 
Revised for Turb 
Equates changed 
Clear status lin 



I DENT TWXTV 



INSERT 
INSERT 



LINE25: 
SI COPE: 
SOCODE: 
RSTCOD: 

» 

TWXSI: : 



TWXSG; 



DREQUATE 
TEQUATE 

.LOG 



TWXRST: 



.BYTE 

.BYTE 

.BYTE 

. BYTE 

.LOC 

PUSH 

PUSH 

PUSH 

?USH 

LXI 

JMPR 



PUSH 

PUSH 

PUSH 

PUSH 

ORI 

STA 

LXI 

JMPR 



PUSH 



.DATA.# 



ABEL , AESC , 67H , AESC , 66H , AESC , 47H , 3CH , ^ 

ACR, 0,0, 0,0, 0,0, 0,0,0 

AESC , 68H ,0,0,0,0,0,0,0,0 

. PROG . # 

PSW ; SAVE REGISTERS 

B ; . 

D 

H 

H.SICODE 

SCONT 



PSW 

B 

D 

H 

OFFH 

LINE25 

H, SOCODE 

SCONT 



PSW 



SET HL FOR SHIFT IN 

; SAVE REGISTERS 

SIGNAL THAT A MESSAGE 
SET HL FOR SHIFT OUT 

; SAVE REGISTERS 
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TWXTV driver 



Cj18' 


C5 




PUSH 


B 


0019' 


D5 




PUSH 


D 


001A' 


E5 




PUSH 


H 


001B' 


AF 




XBA 


A 


001C 


32 0000" 




STA 


LINE25 


001F' 


21 0015" 




LXI 


H,RSTC0D 


0022' 




SC0NT : 






0022' 


3A 0000:04 




LDA 


C0NAST# 


0025' 


57 




MOV 


D,A 


0026' 




CL00P: 






0026 ' 


7E 




MOV 


A,M 


0027' 


B7 




ORA 


A 


UUAO 


6QU£i 




TTsrr 

UU£i 


CITSTJim 
OXUCJJ. 


002A' 


5F 




MOV 


E,A 


002B' 




CMOUTO : 


: 




002B' 


0E24 




MVI 


C.24H 


002D' 


D5 




PUSH 


D 


002E' 


E5 




PUSH 


H 


002P' 


AF 




XBA 


A 


0030' 


CD 0000:05 




CALL 


XTNTRY# 


0033' 


El 




POP 


H 


0034' 


Dl 




POP 


D 


0035' 


23 




INX 


H 


0036' 


18EE 




JMPR 


CLOOP 


JT038 ' 
lb039' 


El 


SRET: 


POP 


H 


Dl 




POP 


D 


003A' 


CI 




POP 


B 


003B' 


Fl 




POP 


PSW 


003C 


C9 




RET 





SIGNAL THAT NO MESSAGE 

SET HL FOR SHIFT OUT 

GET CONSOLE CHANNEL IK 

FOR EACH BYTE DO 
GET BYTE IN E 



SET PARM FOR CONOUT 
SAVE CHANNEL NUMBEB 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 



RETURN 



END 
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INSTALLING BACKGROUND BATCH 



Lo 



verview 



The Turbo-Plus Background Batch System operates on its own 
dedicated slave hoard. It requires a number of .COM files and 
related data files. It allows job scheduling, maintains a log of 
batch operation, and offers utilities to list current and pending 
jobs and to delete jobs. 

The batch system requires two user areas: one on the system 
boot disk, and another on user zero of any drive on the system. 
Furthermore, it requires the presence of supporting .COM files in 
user of the system search drive. All of the modules can be 
easily installed in any user area using the background batch 

J_.~4.11_4.£.»._ _ _. _ .r ~ .._ ISBTVOnilT 

iiiouaiiaiiiuii jjrugiaiu, o o ± xm o j. au . 

Patching 

The program modules which require patching are BB, BBACK, 
BBCANCBL, BBDEL, BBEGIN, BBLIST, and BBLOG. The patches are 
needed to tell the batch system on which user area its files will 
be kept. To do this customization, run the BBINSTAL program 
included on the distribution diskette. This program will issue a 
series of questions about the manner in which you want to set up 
your background batch. It will then proceed to generate the 
necessary parameter files, and start a DO process to generate the 
.COM files, and move all of the modules to the necessary user 

Creas on the system. A sample background batch installation 
ession follows. All user input is underlined. 

5F}BBINSTAL 

BB requires one user area on the system boot disk where a 
WARMSTRT.AUT file will be placed. Nobody else should log 
on to this area of the boot disk. Which area would you 
like this to be? (1-30): 1 

BB requires one user area anywhere else on the system 
where it maintains all of its files. This should be 
preferably on the hard disk, if you have one. It will 
use user on the drive you select. 

What drive would you like it to use? (A-P): H 

What is your system search drive? (A-P): H 

The Background Batch processor will require one slave 
board dedicated to it. Which slave will you set up 
to service the background batch? (A-P): B 
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BB 

TPMOD 

Pass 1 

BB TPEQU TPMOD 

Pass 2 

BB TPBQTJ TPMOD 

Processing parameter file: 

DBIYE = 07 



Writing output file 



5F}C0P¥ 

* BEEGIN.COM 01A: WABMSTRT . AUT;N 



5P:BBEGIN 


.COM 


copied 


to 


1A: 


:WARMSTHT 


.AUT 


* BB.COM OH: 


;N 












5F:BB 


.COM 


copied 


to 


OH: 


:BB 


.COM 


* BBLIST.COM OH: ;N 












5P:BBLIST 


.COM 


copied 


to 


OH: 


:BBLIST 


. COM 


* BBACK.COM 


OH: ;N 












5F:BBACK 


.COM 


copied 


to 


OH: 


: BBACK 


.COM 


* BBLOG COM 


OH: ;N 












5F : BBLOG 


.COM 


copied 


to 


OH: 


: BBLOG 


.COM 


* BBCUB.JOB 


OH: ;N 












5F : BBCUR 


.JOB 


copied 


to 


OH: 


:BBCUH 


.JOB 


* BE JOBS OH: 


;N 












8F:BBJ0BS 


. 


copied 


to 


OH: 


:BBJOBS 


# 


* BBLOG 01H: 


;H 












5F: BBLOG 

* 


• 


copied 


to 


OH: 


: BBLOG 


• 



oF s 
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Slave Generation 

r Finally, a number of modifications to youp system generation 
_ust be completed: 

Two changes must be made in the system .SYS files: First, a 
new slave must be generated for the batch system. This slave 
should have one change made in its .GEN file: Replace its console 
driver (typically C0N96) with CONBB.REL, also supplied on user 
of the installation disk. The slave's .PAH file should be 
changed with the LOGUSB parameter included, setting up the slave 
to log automatically onto the user area containing WARMS TRT . AUT . 
(E.g. If you choose to warmstart into user 1 of the boot drive, 
the patch should be LOGUSR ■ 1.) It is also advisable to have 
this slave printing to some remote queue op to file, pathep than 
directly to a printer or to console, since in the latter two 
cases it would be easy to lose desired output produced by any 
jobs punning in the batch processor. This is accomplished via 
the PRTMOD and QUEPTR parameters documented in the TurboDOS 
Configuration Guide. This slave must then be generated into the 
system master file, by changing the slave table, 23MBSLY 
parameter, and NMBXXX parameter (where XXX is the particular 
slave.) The new slave and master must be generated in the normal 
system generation manner, and the Turbo-Plus batch system will be 
ready for operation upon system reset. 
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Appendix A 
Modifying a Slave Circuit Driver for Turbo-Plus 

If you are using slave boards with incorrect circuit 
drivers, it is highly recommended that you patch the slave 
circuit driver source code (SCD???.ASM) in order to use TWX and 
RESET commands. 

The change to be made occurs at the end of the interrupt 
service routine in the circuit driver. If the last two lines of 
your routine are: 

TP.T ♦ "RriAhl a Tntfl?TUT)ta 

_ _ j — —- — » — — •- ■— ■ — — — ^- 

RET I ; Return 

replace them with: 

JMP ISRXIT# ; Jump to ISR exit 

If the last two lines of that routine are different, contact your 
dealer . 
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Appendix B 

Installing Turbo-Plus on a Multi-circuit System 

It is possible that your system has two types of slave 
boards installed, in which case you will need to add one extra 
patch to the master .PAR file. This patch is for the Turbo-Plus 
slave table, and has the label TPSTBL, with the follwing default 
value: 

TPSTBL = (0001), (0002), (0003), ( 0004) ,( 0005) ,( 0006) , (0007), (0008) 
(0009) , (000A) , (000B) , (000C) , (000D) , (000E) , (000F) , (0010) 

The sixteen words in this table contain the network 
addresses of the slaves which Turbo-Pius will refer to as A 
through P respectively. Thus, under the default configuration, a 
single circuit with up to sixteen slaves will define those slaves 
as A-P in the order that they are referred to in your circuit 
driver's port assignment table. 

For a specific example, let us consider a system having 
three slave circuits, with five slaves on the first, two on the 
second, and four on the third. In this case, we are only worried 
about the first eleven entries in the table. We must change the 
network addresses of slaves F-K, as follows: 

TPSTBL = (0001), (0002), (0003), (0004), (0005), (0101), 
(0102) , (0201) , (0202) , (0203) , (0204) 
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Following is a proposal for a parameter passing protocol for 
the TurboDOS user function. This convention will allow for the 
coexistence of numerous user function packages in a TurboDOS 
system. At this time it is generally not possible to use more 
than one user function in a given system configuration. The 
design of this protocol takes into account ail actively used 
versions of TurboDOS, including VI. 40, in which the methods for 
routing user function requests have been altered. 



BACKGROUND 

Current Problems 

There are currently two primary problems in using multiple user 
motion packages produced by independent authors: 

1) TurboDOS provides only one user function entry point 
(TTSEFCN), so methods for including multiple functions 
must be mutually agreed upon by all concerned user 
function authors. 

2) All authors of user functions must choose their own 
exclusive range of sub-function numbers in order to avoid 
conflict. To date, this has not been an issue since 
only one user function may be included in a system 
generation. 

Current Conventions 

There are two commonly used user function parameter passing 
protocols: The first uses the E register as the sub-function 
number and the HL register pair for other arguments. The second 
passes sub-functions in the L register and uses the DE pair for 
word length arguments. 

However, TurboDOS version 1.4 uses the DE pair to specify network 
routing. Therefore, to create user functions compatible with all 
versions of TurboDOS, only the HL pair may be used for passing 
parameters to user functions. Any additional parameters must be 
passed through the DMA transfer area. 
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DESIGN PBOPOSAL 
Design Goal 

The goal of this design is to create a standard application- 
independent interface for the TurboDOS user function that will 
allow multiple user function packages to be included in a system 
configuration without requiring that the respective authors 
coordinate their entry point naming and sub-function number 
usage. 

User Function Initialization 



A general purpose INIT time sntry point 
initialization routine is required. While 
incorporated such an entry point into 
initialization routines, our goal is to 
hardware and software independent. 



for a user function 

a number of OEM's have 

their own hardware 

keep this convention 



We propose, therefore, to create a user function initialization 
entry point via the method currently used by the Turbo-Plus 
software package. This procedure involves patching a jump from 
the LCLUSR initialization routine to the user function 
initialisation entry point. The patch LCLNIT + 7 ■ USBNIT under 
versions 1,82 and 1.30, and LCLNIT + OD = TJ8BNIT under version 
1.40 forces the LCLUSR initialization routine to jump to our 
initialization routine, instead of CLBNIT, as its last jump. 
Thus, we may use this convention to support an initialization 
routine with the entry point USRNIT: : . After user function 
initialization, a jump will be made to CLBNIT# . 

Note: Under TurboDOS VI. 41, the USRSUP module and a kernel level 
initialization-time call to USRNIT are being supplied with 
TurboDOS by Software 2000. Therefore, the preceding paragraph 
can be ignored for users of VI. 41 or later. 

The USRNIT initialization routine will support an arbitrary 
number of user function packages (8 seems reasonable). USRNIT 
will call USRINA#, USRINB# , USRINC# , etc. If the called USRIN96 
routine is present, our convention specifies that the routine 
return the number of subfunctions required in the A register, and 
an eight byte package name at the address pointed to by the value 
returned in the HL register pair. Thus, a return code of in 
the A register will mean that either the user-defined function 
did not exist (in which case the TurboDOS ,UND. : : routine will 
return a 0) or it was merely a piece of initialization code which 
did not support any subfunctions. The main initialization 
routine will store each returned package name and computed 
function base in an internal table. 

User Function Package Entry Points 

User function packages conforming to our protocol will use the 
entry point USRFC96: : . One common module, also supplied by the 
authors of this proposal, will be responsible for dispatching 
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each included user function package when a call to XJSEFCN is 
.made . 

ailing Sequence for Application Programs 

Our protocol requires that one change be made to each application 
program that will call user functions. At the beginning of each 
program that will call a user function, a call must be made to 
the user function sub-function 0. The user function package name 
that the program is to access is passed at the DMA address. The 
user function call returns with in the A register, indicating 
that the package is not available, or with a user function sub- 
function offset. The calling program may, from then on, access 
the requested user function package by calling USRPCN and adding 
the returned offset to the package's sub-function number. 

When the main USHFCN dispatch routine is called, it will know 
from the range of the sub-function which user-function package is 
desired. It will then subtract the appropriate offset from the 
sub-function and jump to the correct package. In this fashion, 
all user function packages may be coded with sub-function numbers 
beginning with 0. 

If a program must route user functions to multiple destinations, 
then an initialization call in the program is necessary for each 
of those destinations. This procedure is necessary in case the 
user function is genned in different locations in the various 
destinations. The sub-function offsets must be saved and re-used 
f henever calls are made to the corresponding user function 
packages. Although these initialization calls add a small one 
time overhead, the added flexibility is well worth the computing 
time cost. 

COMMENTS 

Although this protocol is significantly more complicated than the 
de facto standard of pre-allocating sub-function numbers between 
authors, a flexible convention must be designated. Therefore it 
is worth any recoding necessary to guarantee the possibility of 
user function coexistence in the future. 



